W09-2. ConfigMap · Secret · PV/PVC - 실습 가이드
9주차 실습: 방명록 + PostgreSQL 을 Kubernetes 로 이전
- Secret 을 만들고, 값이 base64 로만 저장된다는 것을 직접 확인한다.
- PVC 를 쓰는 PostgreSQL 을 띄우고, PVC 가 Pending → Bound 되는 과정을 본다.
- ConfigMap + Secret 으로 방명록을 DB 에 연결하고, Pod 3개가 같은 글을 보여 주는 것을 확인한다.
- Pod 를 다 지워도 데이터가 남는 것, ConfigMap 을 바꾸면 재시작해야 반영되는 것을 확인한다.
- Kubernetes running, 컨텍스트
docker-desktop - 작업 폴더: macOS
cd ~/docker-study/k8s/ Windowscd "$HOME\docker-study\k8s" - 8주차에 만든 것이 남아 있어야 합니다. 확인:
kubectl get deployment,service,gateway,httproutedeployment.apps/guestbook,service/guestbook,gateway.../study-gateway,httproute.../guestbook이 보이면 OK.- 없다면 8주차 실습의 실습 1, 4, 5 를 먼저 하세요(Envoy Gateway 설치 포함, 약 15분).
| 실습 | 내용 | 시간 |
|---|---|---|
| 1 | Secret 만들기와 들여다보기 | 6분 |
| 2 | PostgreSQL + PVC | 9분 |
| 3 | ConfigMap 만들기 | 3분 |
| 4 | 방명록을 DB 에 연결 | 10분 |
| 5 | 다 지워도 데이터는 남는다 | 6분 |
| 6 | ConfigMap 바꾸기 | 6분 |
| 7 | 정리 | 2분 |
실습 1. Secret 만들기와 들여다보기
1-1. 명령으로 만들기
비밀번호가 파일에 남지 않도록 명령으로 만듭니다.
kubectl create secret generic postgres-secret --from-literal=POSTGRES_PASSWORD=guestpw
kubectl get secret postgres-secret
출력 예시:
secret/postgres-secret created
NAME TYPE DATA AGE
postgres-secret Opaque 1 0s
DATA 1은 키가 1개(POSTGRES_PASSWORD) 들어 있다는 뜻입니다.kubectl get으로는 값이 보이지 않습니다.
1-2. 정말 안전할까? 값 꺼내 보기
kubectl get secret postgres-secret -o jsonpath='{.data.POSTGRES_PASSWORD}'
출력: Z3Vlc3Rwdw==
이것을 되돌려 봅니다.
macOS:
kubectl get secret postgres-secret -o jsonpath='{.data.POSTGRES_PASSWORD}' | base64 --decode
Windows (PowerShell):
$enc = kubectl get secret postgres-secret -o jsonpath='{.data.POSTGRES_PASSWORD}'
[Text.Encoding]::UTF8.GetStringFromBase64String($enc)
출력: guestpw
Secret 의 값은 base64 로 인코딩되어 있을 뿐 암호화가 아닙니다. Secret 을 읽을 권한이 있으면 비밀번호를 그대로 알 수 있습니다.
그래서 Secret YAML 을 Git 에 올리지 않고, 읽을 수 있는 사람을 권한(RBAC) 으로 제한합니다(강의 노트 4장).
실습 2. PostgreSQL + PVC
2-1. postgres.yaml
VS Code 로 k8s 폴더에 postgres.yaml 을 만듭니다. PVC + Deployment + Service 세 개가 --- 로 나뉘어 들어 있습니다.
apiVersion: v1
kind: PersistentVolumeClaim
metadata:
name: postgres-data
spec:
accessModes:
- ReadWriteOnce
resources:
requests:
storage: 1Gi
---
apiVersion: apps/v1
kind: Deployment
metadata:
name: postgres
spec:
replicas: 1
strategy:
type: Recreate
selector:
matchLabels:
app: postgres
template:
metadata:
labels:
app: postgres
spec:
containers:
- name: postgres
image: postgres:18-alpine
env:
- name: POSTGRES_USER
value: guest
- name: POSTGRES_DB
value: guestbook
- name: POSTGRES_PASSWORD
valueFrom:
secretKeyRef:
name: postgres-secret
key: POSTGRES_PASSWORD
ports:
- containerPort: 5432
volumeMounts:
- name: data
mountPath: /var/lib/postgresql
readinessProbe:
exec:
command: ["pg_isready", "-h", "localhost", "-U", "guest", "-d", "guestbook"]
periodSeconds: 5
volumes:
- name: data
persistentVolumeClaim:
claimName: postgres-data
---
apiVersion: v1
kind: Service
metadata:
name: postgres
spec:
selector:
app: postgres
ports:
- port: 5432
targetPort: 5432
| 부분 | 의미 |
|---|---|
PersistentVolumeClaim storage: 1Gi |
"1GB 저장소가 필요해요" 라는 요청서 |
strategy: type: Recreate |
업데이트할 때 옛 DB Pod 를 먼저 끄고 새 Pod 를 켬 (DB 는 동시에 2개 뜨면 위험) |
secretKeyRef |
실습 1 의 Secret 에서 비밀번호를 가져옴 |
mountPath: /var/lib/postgresql |
PostgreSQL 18 의 데이터 폴더 (3주차와 같은 경로) |
readinessProbe |
pg_isready 가 성공해야 준비 완료로 보고 Service 에 넣음 |
Service: postgres |
방명록이 postgres:5432 라는 이름으로 접속할 주소 |
2-2. 적용하고 PVC 지켜보기
kubectl apply -f postgres.yaml
kubectl get pvc
출력 예시: 처음에는 Pending 입니다.
persistentvolumeclaim/postgres-data created
deployment.apps/postgres created
service/postgres created
NAME STATUS VOLUME CAPACITY ACCESS MODES STORAGECLASS VOLUMEATTRIBUTESCLASS AGE
postgres-data Pending standard <unset> 0s
DB 가 준비될 때까지 기다린 뒤 다시 봅니다.
kubectl rollout status deployment/postgres
kubectl get pvc
kubectl get pv
출력 예시:
deployment "postgres" successfully rolled out
NAME STATUS VOLUME CAPACITY ACCESS MODES STORAGECLASS VOLUMEATTRIBUTESCLASS AGE
postgres-data Bound pvc-4f9cfa8c-7669-457a-a771-b965de01e6c8 1Gi RWO standard <unset> 15s
NAME CAPACITY ACCESS MODES RECLAIM POLICY STATUS CLAIM STORAGECLASS VOLUMEATTRIBUTESCLASS REASON AGE
pvc-4f9cfa8c-7669-457a-a771-b965de01e6c8 1Gi RWO Delete Bound default/postgres-data standard <unset> 13s
- PVC(요청서)만 있을 때는
Pending - PVC 를 쓰는 PostgreSQL Pod 가 생기자 StorageClass
standard가 PV 를 자동으로 만들고 연결 →Bound - PV 이름
pvc-…는 자동으로 붙은 이름입니다. 우리는 PV 를 직접 만들지 않았습니다.
kubectl get storageclass
출력 예시:
NAME PROVISIONER RECLAIMPOLICY VOLUMEBINDINGMODE ALLOWVOLUMEEXPANSION AGE
hostpath rancher.io/local-path Delete WaitForFirstConsumer false 97m
standard (default) rancher.io/local-path Delete WaitForFirstConsumer false 97m
standard (default): PVC 에 StorageClass 를 안 적으면 이것을 씁니다.WaitForFirstConsumer가 "Pod 가 생길 때 만든다" 는 뜻입니다.
실습 3. ConfigMap 만들기
configmap.yaml
apiVersion: v1
kind: ConfigMap
metadata:
name: guestbook-config
data:
APP_VERSION: "v2-k8s"
DB_HOST: "postgres"
DB_NAME: "guestbook"
DB_USER: "guest"
kubectl apply -f configmap.yaml
kubectl get configmap guestbook-config -o yaml
ConfigMap 은 Secret 과 달리 값이 그대로 보입니다. 비밀이 아닌 설정만 넣습니다.
APP_VERSION을 넣은 이유: 이미지 안의 기본값(v2)을 이미지를 다시 만들지 않고 바꿀 수 있는지 확인하려는 것입니다.
실습 4. 방명록을 DB 에 연결
4-1. deployment.yaml 고치기
deployment.yaml 을 아래처럼 바꿉니다. 바뀐 곳은 두 군데입니다: change-cause 문구, 그리고 ports: 아래에 envFrom: 과 env: 추가. 내아이디 는 그대로 본인 아이디입니다.
apiVersion: apps/v1
kind: Deployment
metadata:
name: guestbook
labels:
app: guestbook
annotations:
kubernetes.io/change-cause: "v2 + PostgreSQL 연결"
spec:
replicas: 3
selector:
matchLabels:
app: guestbook
template:
metadata:
labels:
app: guestbook
spec:
containers:
- name: web
image: 내아이디/guestbook:v2
ports:
- containerPort: 8000
envFrom:
- configMapRef:
name: guestbook-config
env:
- name: DB_PASSWORD
valueFrom:
secretKeyRef:
name: postgres-secret
key: POSTGRES_PASSWORD
- name: DATABASE_URL
value: "postgresql://$(DB_USER):$(DB_PASSWORD)@$(DB_HOST):5432/$(DB_NAME)"
envFrom: 과 env: 는 ports: 와 같은 칸(image: 와 같은 칸)에 있어야 합니다.
4-2. 적용
kubectl apply -f deployment.yaml
kubectl rollout status deployment/guestbook
4-3. Pod 안의 환경 변수 확인
kubectl exec deploy/guestbook -- env
deploy/guestbook이라고 쓰면 Deployment 의 Pod 중 하나를 골라 실행합니다. Pod 이름을 찾을 필요가 없습니다.
출력 예시 (일부):
APP_VERSION=v2-k8s
DATABASE_URL=postgresql://guest:guestpw@postgres:5432/guestbook
DB_HOST=postgres
DB_NAME=guestbook
DB_PASSWORD=guestpw
DB_USER=guest
...
$(DB_USER)같은 자리에 ConfigMap 과 Secret 의 값이 채워져DATABASE_URL이 완성됐습니다.APP_VERSION이 이미지의v2가 아니라 ConfigMap 의v2-k8s로 바뀌었습니다.- Pod 안에서는 비밀번호가 평문으로 보입니다. 그래서
exec권한도 함부로 주면 안 됩니다.
4-4. 브라우저 확인
http://guestbook.localhost 를 엽니다.
- 머리글: 방명록 v2-k8s
- 저장소: PostgreSQL ✅
글을 2~3개 남기고, 새로고침을 여러 번 해 보세요. HOSTNAME(Pod 이름)이 바뀌어도 글 목록은 항상 같습니다.
관찰 예시 (실제로 확인한 결과): 응답한 Pod 끝 5글자 : 보이는 글 개수
fz6d2:1 pfvdl:1 s9t6k:1 pfvdl:1 s9t6k:1 s9t6k:1 s9t6k:1 fz6d2:1 s9t6k:1
Pod 3개가 모두 같은 PostgreSQL 을 보기 때문입니다. 웹(앱)은 상태가 없게(Stateless) 만들고, 상태(데이터)는 DB 에 두는 것이 늘리고 줄이기 쉬운 구조의 기본입니다.
4-5. DB 에서 직접 확인
kubectl exec deploy/postgres -- psql -U guest -d guestbook -c "SELECT id, name, body FROM messages;"
출력 예시:
id | name | body
----+---------+--------------
1 | Soojong | moved to k8s
(1 row)
실습 5. 다 지워도 데이터는 남는다
5-1. 방명록 Pod 전부 삭제
kubectl delete pods -l app=guestbook
kubectl rollout status deployment/guestbook
→ 새 Pod 3개가 생기고, 브라우저를 새로고침하면 글이 그대로 있습니다. (방명록 Pod 에는 원래 데이터가 없으니 당연합니다.)
5-2. DB Pod 삭제
이번에는 DB 를 지웁니다.
kubectl delete pod -l app=postgres
kubectl rollout status deployment/postgres
kubectl get pods -l app=postgres
출력 예시: 새 이름의 PostgreSQL Pod 가 Running 입니다.
pod "postgres-57c84bcc6-rrm7j" deleted from default namespace
deployment "postgres" successfully rolled out
NAME READY STATUS RESTARTS AGE
postgres-57c84bcc6-b4wx4 1/1 Running 0 12s
kubectl exec deploy/postgres -- psql -U guest -d guestbook -c "SELECT count(*) FROM messages;"
→ 남긴 글 개수가 그대로입니다. 브라우저에서도 글이 그대로 보입니다.
kubectl describe pvc postgres-data
Used By: 에 새 Pod 이름이 보입니다. Pod 는 바뀌어도 데이터(PV)는 그대로입니다. 3주차 "컨테이너는 버려도 데이터는 볼륨에" 의 Kubernetes 버전입니다.
그사이 방명록 페이지를 열면 Internal Server Error 가 날 수 있습니다. DB 가 1개뿐이라 생기는 짧은 중단입니다. 실무에서 DB 이중화나 관리형 DB 를 쓰는 이유입니다.
실습 6. ConfigMap 바꾸기
configmap.yaml 의 APP_VERSION: "v2-k8s" 를 APP_VERSION: "v2-k8s-config2" 로 바꾸고 저장합니다.
kubectl apply -f configmap.yaml
http://guestbook.localhost 를 새로고침하면 → 머리글은 아직 v2-k8s 입니다.
환경 변수는 Pod 가 시작될 때 한 번만 읽기 때문입니다. 이미 떠 있는 Pod 는 예전 값을 그대로 갖고 있습니다.
Pod 를 새로 띄웁니다(이미지는 그대로, Pod 만 교체).
kubectl rollout restart deployment/guestbook
kubectl rollout status deployment/guestbook
새로고침 → 머리글이 v2-k8s-config2 로 바뀌었습니다. 글은 그대로입니다.
같은 이미지를 개발·운영에서 다른 ConfigMap 으로 띄우는 것이 바로 이 방식입니다.
실습 7. 정리
10주차에도 모두 그대로 씁니다. 지우지 마세요.
kubectl get deployment,service,configmap,secret,pvc
출력 예시 (일부):
NAME READY UP-TO-DATE AVAILABLE AGE
deployment.apps/guestbook 3/3 3 3 17m
deployment.apps/postgres 1/1 1 1 67s
NAME TYPE CLUSTER-IP EXTERNAL-IP PORT(S) AGE
service/guestbook ClusterIP 10.96.134.220 <none> 80/TCP 13m
service/kubernetes ClusterIP 10.96.0.1 <none> 443/TCP 102m
service/postgres ClusterIP 10.96.242.135 <none> 5432/TCP 67s
NAME DATA AGE
configmap/guestbook-config 4 55s
configmap/kube-root-ca.crt 1 102m
NAME TYPE DATA AGE
secret/postgres-secret Opaque 1 68s
NAME STATUS VOLUME CAPACITY ACCESS MODES STORAGECLASS VOLUMEATTRIBUTESCLASS AGE
persistentvolumeclaim/postgres-data Bound pvc-19bd6110-57f1-4ad8-bda6-e3bc469056b2 1Gi RWO standard <unset> 67s
StorageClass 의 RECLAIMPOLICY 가 Delete 라서, PVC 를 지우면 PV 와 데이터가 함께 삭제됩니다. 5주차 docker compose down -v 와 같습니다.
자주 나는 문제와 해결
| 증상 | 원인 | 해결 |
|---|---|---|
PostgreSQL Pod 가 CreateContainerConfigError |
Secret 이 없거나 이름·키가 틀림 | kubectl get secret postgres-secret, 키 이름 POSTGRES_PASSWORD 확인 |
PVC 가 계속 Pending |
이 PVC 를 쓰는 Pod 가 아직 없음 (정상), 또는 claimName 오타 |
PostgreSQL Pod 상태 확인, claimName: postgres-data 확인 |
PostgreSQL Pod READY 0/1 이 오래감 |
초기화 중 (readinessProbe 대기) | kubectl logs deploy/postgres 로 ready to accept connections 확인 |
방명록 Internal Server Error |
DB 연결 실패 (DB 재시작 중, 비밀번호·주소 오류) | kubectl logs deploy/guestbook, kubectl exec deploy/guestbook -- env 로 DATABASE_URL 확인 |
password authentication failed for user "guest" (방명록 로그) |
Secret 비밀번호를 바꿨는데 예전 PVC 의 DB 를 그대로 씀 | 비밀번호는 DB 를 처음 만들 때만 적용. 실습이면 PostgreSQL Deployment 와 PVC 를 지우고 다시 |
DATABASE_URL 에 $(DB_USER) 가 글자 그대로 남음 |
ConfigMap 이 없거나, envFrom 이 env 보다 아래/잘못된 위치 |
실습 3 적용 확인, 4-1 의 들여쓰기 확인 |
| ConfigMap 을 바꿨는데 반영 안 됨 | 환경 변수는 시작할 때만 읽음 | kubectl rollout restart deployment/guestbook |
error: unable to upgrade connection: container not found (exec) |
종료 중인 Pod 를 고름 | 잠시 뒤 다시, 또는 deploy/이름 형식 사용 |
오늘 쓴 명령어 정리
| 명령어 | 하는 일 |
|---|---|
kubectl create secret generic 이름 --from-literal=키=값 |
Secret 만들기 |
kubectl get secret 이름 -o jsonpath='{.data.키}' |
Secret 값(base64) 보기 |
base64 --decode (macOS) / [Convert]::FromBase64String() (Windows) |
base64 되돌리기 |
kubectl get pvc / kubectl get pv / kubectl get storageclass |
저장소 확인 |
kubectl describe pvc 이름 |
PVC 상세 (Used By) |
kubectl get configmap 이름 -o yaml |
ConfigMap 내용 |
kubectl exec deploy/이름 -- 명령 |
Deployment 의 Pod 하나에서 실행 |
kubectl rollout restart deployment/이름 |
이미지 그대로 Pod 만 새로 교체 |
복습 과제
확인 퀴즈
- 설정을 이미지 안에 넣지 않고 ConfigMap / Secret 으로 분리하는 이유는?
- Secret 이 "암호화가 아니다" 라는 말의 뜻과, 그래서 지켜야 할 것은?
- PVC, PV, StorageClass 는 각각 무엇인가요?
- PVC 가 처음에
Pending이었다가Bound가 된 이유는? - PostgreSQL Deployment 에
replicas: 1과strategy: Recreate를 쓴 이유는? - ConfigMap 의
APP_VERSION을 바꾸고 apply 했는데 화면이 그대로였습니다. 이유와 해결 방법은? - 방명록 Pod 3개가 모두 같은 글을 보여 주게 된 이유는?
- 같은 이미지를 환경(개발·운영)마다 다른 설정으로 쓰기 위해서, 그리고 비밀번호가 이미지에 남지 않게 하기 위해서입니다.
- Secret 값은 base64 인코딩일 뿐이라 누구나 되돌릴 수 있습니다. 그래서 Git 에 올리지 않고, RBAC 로 읽을 사람을 제한하고, 실무에서는 etcd 암호화나 외부 비밀 저장소를 씁니다.
- PVC 는 저장소 요청서, PV 는 실제 저장 공간, StorageClass 는 요청이 오면 PV 를 자동으로 만들어 주는 공급자입니다.
- StorageClass 가
WaitForFirstConsumer방식이라 PVC 를 쓰는 Pod 가 생길 때 PV 를 만들기 때문입니다. - 여러 DB Pod 가 같은 데이터 폴더를 동시에 쓰면 데이터가 깨지기 때문에 하나만 두고, 업데이트할 때도 옛 Pod 를 먼저 끄고 새 Pod 를 켜기 위해서입니다.
- 환경 변수는 Pod 가 시작될 때만 읽기 때문입니다.
kubectl rollout restart deployment/guestbook으로 Pod 를 새로 띄우면 반영됩니다. - 모든 Pod 가 같은 PostgreSQL(Service
postgres) 에 저장하고 읽기 때문입니다. 앱은 상태가 없고(Stateless), 데이터는 DB 에 있습니다.
도전 과제 (선택)
- ConfigMap 을 파일로 넣어 보세요. 아래를
deployment.yaml의 Podspec에 추가하고(containers:와 같은 칸에volumes:,web컨테이너 안ports:와 같은 칸에volumeMounts:),kubectl exec deploy/guestbook -- ls /config로 확인해 보세요. ConfigMap 의 키가 파일 이름이 됩니다.volumeMounts: - name: config mountPath: /config volumes: - name: config configMap: name: guestbook-config kubectl get pv의 PV 를kubectl describe pv <이름>으로 보세요. Node Affinity 항목에 특정 노드 이름이 있습니다. 왜 그럴까요? (힌트: local-path 는 노드의 디스크에 저장합니다. 그래서 DB Pod 는 그 노드에서만 다시 뜰 수 있습니다. 클라우드 블록 스토리지는 이런 제약을 다르게 처리합니다.)
마지막 주에는 운영에 필요한 것들을 맛봅니다. 헬스체크(Probe) 로 고장 난 Pod 를 자동으로 빼고, 리소스 제한과 오토스케일링(HPA) 으로 부하에 따라 Pod 수를 늘리고, Gateway API 로 카나리 배포를 하고, 클라우드의 관리형 Kubernetes(PaaS) 와 비교합니다.
네비게이션
| 이전 | 목록 | 다음 |
|---|---|---|
| ◀ 9주차 강의 노트 | 목록으로 | 10주차 강의 노트 ▶ |